home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Games / Angband290 / help / playing.txt < prev    next >
Text File  |  2000-04-10  |  26KB  |  455 lines

  1. === Playing the Game ===
  2.  
  3.     Most of your interaction with Angband will take the form of "commands".
  4. Every Angband command consists of an "underlying command" plus a variety of
  5. optional or required arguments, such as a repeat count, a direction, or the
  6. index of an inventory object.  Commands are normally specified by typing a
  7. series of keypresses, from which the underlying command is extracted, along
  8. with any encoded arguments.  You may choose how the standard "keyboard keys"
  9. are mapped to the "underlying commands" by choosing one of the two standard
  10. "keysets", the "original" keyset or the "roguelike" keyset.
  11.  
  12.     The original keyset is very similar to the "underlying" command set,
  13. with a few additions (such as the ability to use the numeric "directions" to
  14. "walk" or the "5" key to "stay still").  The roguelike keyset provides similar
  15. additions, and also allows the use of the h/j/k/l/y/u/b/n keys to "walk" (or,
  16. in combination with the shift or control keys, to run or alter), which thus
  17. requires a variety of key mappings to allow access to the underlying commands
  18. used for walking/running/altering.  In particular, the "roguelike" keyset
  19. includes many more "capital" and "control" keys, as shown below.
  20.  
  21.     Note that any keys that are not required for access to the underlying
  22. command set may be used by the user to extend the "keyset" which is being
  23. used, by defining new "keymaps".  To avoid the use of any "keymaps", press
  24. backslash ("\") plus the "underlying command" key.  This is normally only
  25. used in "macro" definitions.  You may enter "control-keys" as a caret ("^")
  26. plus the key (so "^" + "p" yields "^P").
  27.  
  28.     Some commands allow an optional "repeat count", which allows you to tell
  29. the game that you wish to do the command multiple times, unless you press a
  30. key or are otherwise disturbed.  To enter a "repeat count", type '0', followed
  31. by the numerical count, followed by the command.  You must type "space" before
  32. entering certain commands.  Skipping the numerical count yields a count of 99.
  33. An option allows certain commands (open, disarm, alter, etc) to auto-repeat.
  34.  
  35.     Some commands will prompt for extra information, such as a direction, an
  36. inventory or equipment item, a spell, a textual inscription, the symbol of a
  37. monster race, a sub-command, a verification, an amount of time, a quantity,
  38. a file name, or various other things.  Normally you can hit return to choose
  39. the "default" response, or escape to cancel the command entirely.
  40.  
  41.     Some commands will prompt for a spell or an inventory item.  Pressing
  42. space (or '*') will give you a list of choices.  Pressing "-" (minus) selects
  43. the item on the floor.  Pressing a lowercase letter selects the given item.
  44. Pressing a capital letter selects the given item after verification.  Pressing
  45. a numeric digit '#' selects the first item (if any) whose inscription contains
  46. "@#" or "@x#", where "x" is the current "underlying command".  You may only
  47. specify items which are "legal" for the command.  Whenever an item inscription
  48. contains "!*" or "!x" (with "x" as above) you must verify its selection.
  49.  
  50.     Some commands will prompt for a direction.  You may enter a "compass"
  51. direction using any of the "direction keys" shown below.  Sometimes, you may
  52. specify that you wish to use the current "target", by pressing "t" or "5", or
  53. that you wish to select a new target, by pressing "*" (see "Target" below).
  54.  
  55.         Original Keyset Directions       Roguelike Keyset Directions
  56.  
  57.                  7  8  9                           y  k  u
  58.                  4     6                           h     l
  59.                  1  2  3                           b  j  n
  60.  
  61.  
  62.     Each of the standard keysets provides some short-cuts over the "underlying
  63. commands".  For example, both keysets allow you to "walk" by simply pressing
  64. an "original" direction key (or a "roguelike" direction key if you are using
  65. the roguelike keyset), instead of using the "walk" command plus a direction.
  66. The roguelike keyset allows you to "run" or "alter" by simply holding the
  67. shift or control modifier key down while pressing a "roguelike" direction key,
  68. instead of using the "run" or "alter" command plus a direction.  Both keysets
  69. allow the use of the "5" key to "stand still", which is most convenient when
  70. using the original keyset.
  71.  
  72.     Note that on many systems, it is possible to define "macros" to various
  73. keys, or key combinations, so that it is often possible to make macros which,
  74. for example, allow the use of the shift and/or control modifier keys, plus a
  75. numeric keypad key, to specify the "run" or "alter" command, with the given
  76. direction, regardless of any keymap definitions, by using the fact that you
  77. can always, for example, use "\" + "." + "6", to specify "run east".
  78.  
  79.  
  80.  
  81. === Original Keyset Command Summary ===
  82.  
  83.  a  Aim a wand                           A  Activate an artifact
  84.  b  Browse a book                        B  Bash a door
  85.  c  Close a door                         C  Character description
  86.  d  Drop an item                         D  Disarm a trap
  87.  e  Equipment list                       E  Eat some food
  88.  f  Fire an item                         F  Fuel your lantern/torch
  89.  g  Stay still (flip pickup)             G  Gain new spells/prayers
  90.  h  (unused)                             H  (unused)
  91.  i  Inventory list                       I  Observe an item
  92.  j  Jam a door                           J  (unused)
  93.  k  Destroy an item                      K  (unused)
  94.  l  Look around                          L  Locate player on map
  95.  m  Cast a spell                         M  Full dungeon map
  96.  n  (unused)                             N  (unused)
  97.  o  Open a door or chest                 O  (unused)
  98.  p  Pray a prayer                        P  (unused)
  99.  q  Quaff a potion                       Q  Quit (commit suicide)
  100.  r  Read a scroll                        R  Rest for a period
  101.  s  Search for traps/doors               S  Toggle search mode
  102.  t  Take off equipment                   T  Dig a tunnel
  103.  u  Use a staff                          U  (unused)
  104.  v  Throw an item                        V  Version info
  105.  w  Wear/wield equipment                 W  (unused)
  106.  x  (unused)                             X  (unused)
  107.  y  (unused)                             Y  (unused)
  108.  z  Zap a rod                            Z  (unused)
  109.  !  Interact with system                ^A  (special - debug command)
  110.  @  Interact with macros                ^B  (unused)
  111.  #  (unused)                            ^C  (special - break)
  112.  $  User interface                      ^D  (unused)
  113.  %  Interact with visuals               ^E  Toggle choice window
  114.  ^  (special - control key)             ^F  Repeat level feeling
  115.  &  Interact with colors                ^G  (unused)
  116.  *  Target monster or location          ^H  (unused)
  117.  (  Load screen dump                    ^I  (special - tab)
  118.  )  Dump screen dump                    ^J  (special - linefeed)
  119.  {  Inscribe an object                  ^K  (unused)
  120.  }  Uninscribe an object                ^L  (unused)
  121.  [  (unused)                            ^M  (special - return)
  122.  ]  (unused)                            ^N  (unused)
  123.  -  Walk (flip pickup)                  ^O  (unused)
  124.  _  Enter store                         ^P  Show previous messages
  125.  +  Alter grid                          ^Q  (unused)
  126.  =  Set options                         ^R  Redraw the screen
  127.  ;  Walk (with pickup)                  ^S  Save and don't quit
  128.  :  Take notes                          ^T  (unused)
  129.  '  (unused)                            ^U  (unused)
  130.  "  Enter a user pref command           ^V  Repeat last command
  131.  ,  Stay still (with pickup)            ^W  (special - wizard mode)
  132.  <  Go up staircase                     ^X  Save and quit
  133.  .  Run                                 ^Y  (unused)
  134.  >  Go down staircase                   ^Z  (special - borg command)
  135.  \  (special - bypass keymap)            |  (unused)
  136.  `  (special - escape)                   ~  Check knowledge
  137.  /  Identify symbol                      ?  Help
  138.  
  139.  
  140.  
  141. === Roguelike Keyset Command Summary ===
  142.  
  143.  a  Zap a rod (Activate)                 A  Activate an artifact
  144.  b  (walk - south west)                  B  (run - south west)
  145.  c  Close a door                         C  Character description
  146.  d  Drop an item                         D  Disarm a trap or chest
  147.  e  Equipment list                       E  Eat some food
  148.  f  Bash a door (force)                  F  Fuel your lantern/torch
  149.  g  Stay still (flip pickup)             G  Gain new spells/prayers
  150.  h  (walk - west)                        H  (run - west)
  151.  i  Inventory list                       I  Observe an item
  152.  j  (walk - south)                       J  (run - south)
  153.  k  (walk - north)                       K  (run - north)
  154.  l  (walk - east)                        L  (run - east)
  155.  m  Cast a spell                         M  Full dungeon map
  156.  n  (walk - south east)                  N  (run - south east)
  157.  o  Open a door or chest                 O  (unused)
  158.  p  Pray a prayer                        P  Browse a book
  159.  q  Quaff a potion                       Q  Quit (commit suicide)
  160.  r  Read a scroll                        R  Rest for a period
  161.  s  Search for traps/doors               S  Jam a door (Spike)
  162.  t  Fire an item                         T  Take off equipment
  163.  u  (walk - north east)                  U  (run - north east)
  164.  v  Throw an item                        V  Version info
  165.  w  Wear/wield equipment                 W  Locate player on map (Where)
  166.  x  Look around                          X  (unused)
  167.  y  (walk - north west)                  Y  (run - north west)
  168.  z  Aim a wand (Zap)                     Z  Use a staff (Zap)
  169.  !  Interact with system                ^A  (special - debug command)
  170.  @  Interact with macros                ^B  (alter - south west)
  171.  #  Toggle search mode                  ^C  (special - break)
  172.  $  (unused)                            ^D  Destroy item
  173.  %  Interact with visuals               ^E  Toggle choice window
  174.  ^  (special - control key)             ^F  Repeat level feeling
  175.  &  Interact with colors                ^G  (unused)
  176.  *  Target monster or location          ^H  (alter - west)
  177.  (  Load screen dump                    ^I  (special - tab)
  178.  )  Dump screen dump                    ^J  (alter - south)
  179.  {  Inscribe an object                  ^K  (alter - north)
  180.  }  Uninscribe an object                ^L  (alter - east)
  181.  [  (unused)                            ^M  (special - return)
  182.  ]  (unused)                            ^N  (alter - south east)
  183.  -  Walk (flip pickup)                  ^O  (unused)
  184.  _  Enter store                         ^P  Show previous messages
  185.  +  Alter grid                          ^Q  (unused)
  186.  =  Set options                         ^R  Redraw the screen
  187.  ;  Walk (with pickup)                  ^S  Save and don't quit
  188.  :  Take notes                          ^T  Dig a Tunnel
  189.  '  (unused)                            ^U  (alter - north east)
  190.  "  Enter a user pref command           ^V  Repeat last command
  191.  ,  Run                                 ^W  (special - wizard mode)
  192.  <  Go up staircase                     ^X  Save and quit
  193.  .  Stay still (with pickup)            ^Y  (alter - north west)
  194.  >  Go down staircase                   ^Z  (special - borg command)
  195.  \  (special - bypass keymap)            |  (unused)
  196.  `  (special - escape)                   ~  Check knowledge
  197.  /  Identify symbol                      ?  Help
  198.  
  199.  
  200.  
  201. === Special Keys ===
  202.  
  203.         Certain special keys may be intercepted by the operating system or
  204. the host machine, causing unexpected results.  In general, these special keys
  205. are control keys, and often, you can disable their special effects.
  206.  
  207.         If you are playing on a UNIX or similar system, then Ctrl-C will
  208. interrupt Angband.  The second and third interrupt will induce a warning
  209. bell, and the fourth will induce both a warning bell and a special message,
  210. since the fifth will quit the game, after killing your character.  Also,
  211. Ctrl-Z will suspend the game, and return you to the original command shell,
  212. until you resume the game with the "fg" command.  There is now a compilation
  213. option to force the game to prevent the "double ctrl-z escape death trick".
  214. The Ctrl-\ and Ctrl-D and Ctrl-S keys should not be intercepted.
  215.  
  216.         It is often possible to specify "control-keys" without actually
  217. pressing the control key, by typing a caret ("^") followed by the key.
  218. This is useful for specifying control-key commands which might be caught
  219. by the operating system as explained above.
  220.  
  221.         Pressing backslash ("\") before a command will bypass all keymaps,
  222. and the next keypress will be interpreted as an "underlying command" key,
  223. unless it is a caret ("^"), in which case the keypress after that will be
  224. turned into a control-key and interpreted as a command in the underlying
  225. angband keyset.  The backslash key is useful for creating macro actions
  226. which are not affected by any keymap definitions that may be in force, for
  227. example, the sequence "\" + "." + "6" will always mean "run east", even if
  228. the "." key has been mapped to a different underlying command.
  229.  
  230.         The "0" and "^" and "\" keys all have special meaning when entered
  231. at the command prompt, and there is no "useful" way to specify any of them
  232. as an "underlying command", which is okay, since they would have no effect.
  233.  
  234.         For many input requests or queries, the special character ESCAPE
  235. will abort the command.  The "[y/n]" prompts may be answered with "y" or
  236. "n", or escape.  The "-more-" message prompts may be cleared (after reading
  237. the displayed message) by pressing ESCAPE, SPACE, RETURN, LINEFEED, or by
  238. any keypress, if the "quick_messages" option is turned on.
  239.  
  240.  
  241. === Command Counts ===
  242.  
  243.         Some commands can be executed a fixed number of times by preceding
  244. them with a count.  Counted commands will execute until the count expires,
  245. until you type any character, or until something significant happens, such
  246. as being attacked.  Thus, a counted command doesn't work to attack another
  247. creature.  While the command is being repeated, the number of times left
  248. to be repeated will flash by on the line at the bottom of the screen.
  249.  
  250.         To give a count to a command, type 0, the repeat count, and then
  251. the command.  If you want to give a movement command and you are using the
  252. original command set (where the movement commands are digits), press space
  253. after the count and you will be prompted for the command.
  254.  
  255.         Counted commands are very useful for time consuming commands, as
  256. they automatically terminate on success, or if you are attacked.  You may
  257. also terminate any counted command (or resting or running), by typing any
  258. character.  This character is ignored, but it is safest to use a SPACE or
  259. ESCAPE which are always ignored as commands in case you type the command
  260. just after the count expires.
  261.  
  262.         You can tell Angband to automatically use a repeat count of 99
  263. with commands you normally want to repeat (open, disarm, tunnel, bash,
  264. alter, etc) by setting the "always_repeat" option.
  265.  
  266.  
  267. === Selection of Objects ===
  268.  
  269.         Many commands will also prompt for a particular object to be used.
  270. For example, the command to read a scroll will ask you which of the
  271. scrolls that you are carrying that you wish to read.  In such cases, the
  272. selection is made by typing a letter of the alphabet.  The prompt will
  273. indicate the possible letters, and will also allow you to type the key
  274. "*", which causes all of the available options to be described.  The list
  275. of choices will also be shown in the Choice window, if you are using a
  276. windows environment and windows are turned on.  Often you will be able to
  277. press "/" to select an object from your equipment instead of your
  278. inventory.  Pressing space once will have the same effect as "*", and
  279. the second time will cancel the command and run the "i" or "e" command.
  280.  
  281.         The particular object may be selected by an upper case or a lower
  282. case letter.  If lower case is used, the selection takes place
  283. immediately.  If upper case is used, then the particular option is
  284. described, and you are given the option of confirming or retracting that
  285. choice.  Upper case selection is thus safer, but requires an extra key
  286. stroke.  Also see the "!*" and "!x" inscriptions, below.
  287.  
  288.         For many commands, you can also use "-" to select an object on the
  289. floor where you are standing.  This lets you read scrolls or quaff
  290. potions, for example, off the dungeon floor without picking them up.
  291.  
  292.         If you enter a number between 0 and 9, the first item engraved
  293. with "@#" where "#" is the number you entered will be selected.  For example,
  294. if you have a shovel engraved with "@0" and you type "w" (for wield) and
  295. then 0, you will wield the shovel.  This is very useful for macros (see
  296. below), since you can use this to select an object regardless of its
  297. location in your pack.  For example, Angband automatically defines a macro
  298. for the key "X" to do "w0".  If you then engrave both your digging
  299. instrument and your primary weapon with @0, pressing X will wield
  300. whichever one is not being currently wielded (letting you quickly switch
  301. between them).  Multiple numbers can be engraved on the same object; for
  302. example, if a sword is engraved with @1@0, then either "w1" or "w0" will
  303. wield it.  Normally, you inscribe "@1@0" on your primary weapon, and
  304. "@2@0" on your digger or secondary weapon.  Note that an inscription
  305. containing "@x#" will act like "@#" but only when the current "Angband
  306. command" is "x".  Thus you can put "@z4" on a rod and "@u4" on a staff,
  307. and then use both "z4" and "u4" as desired.
  308.  
  309.         Note that any object containing "!x" in its inscription, where
  310. "x" is the current "angband command" (or containing "!*" ever) will induce
  311. "verification" whenever that object is "selected".  Thus, inscribing, say,
  312. "!f!k!d" on an object will greatly reduce the odds of you "losing" it by
  313. accident, and inscribing "!*" on an object will allow you to be very paranoid
  314. about the object.  Note that "selling" and "dropping" both use the "d" command.
  315.  
  316.  
  317. === User Pref Files ===
  318.  
  319.         Angband allows you to change various aspects of the game to suit
  320. your tastes.  You may define keymaps (changing the way Angband maps your
  321. keypresses to underlying commands), create macros (allowing you to map a
  322. single keypress to a series of keypresses), modify the visuals (allowing
  323. you to change the appearance of monsters, objects, or terrain features),
  324. change the colors (allowing you to make a given color brighter, darker,
  325. or even completely different), or set options (turning them off or on).
  326.  
  327.         Angband stores your preferences in files called "user pref files",
  328. which contain comments and "user pref commands", which are simple strings
  329. describing one aspect of the system about which the user has a preference.
  330. There are many ways to load a user pref file, and in fact, some of these
  331. files are automatically loaded for you by the game.  All of the files are
  332. kept in the "lib/user/" directory, though you may have to use one of the
  333. command line arguments to redirect this directory, especially on multiuser
  334. systems.  You may also enter single user pref commands directly, using the
  335. special "Enter a user pref command" command, activated by "double quote".
  336. You may have to use the "redraw" command (^R) after changing certain of
  337. the aspects of the game, to allow Angband to adapt to your changes.
  338.  
  339.         When the game starts up, after you have loaded an old character,
  340. or created a new character, some user pref files are loaded automatically.
  341. First, the "pref.prf" file is loaded.  This file contains some user pref
  342. commands which will work on all platforms.  Then one of "font-xxx.prf"
  343. (for normal usage) or "graf-xxx.prf" (for bitmap usage) is loaded.  These
  344. files contain attr/char changes to allow the monsters, objects, and/or
  345. terrain features to look "better" on your system.  Then the "pref-xxx.prf"
  346. file is loaded.  This file contains pre-defined system specific stuff
  347. (macros, color definitions, etc).  Then, the "user-xxx.prf" file is loaded.
  348. This file contains user-defined system specific stuff.  The "user-xxx.prf"
  349. file is used as the "default" user pref file in many places.  The "xxx" is
  350. the "system suffix" for your system, taken from the "main-xxx.c" file which
  351. was used to generate your executable.  Finally, the "Race.prf", "Class.prf",
  352. and "Name.prf" files are loaded, where "Race", "Class", and "Name" are
  353. replaced by the actual race, class, and name of the current character.
  354.  
  355.         Several commands allow you to both load existing user pref files,
  356. create new user pref files, append information to existing user pref files,
  357. and/or interact with various of the user preferences in a more intuitive
  358. way than the user pref commands allow.  The commands include "Interact with
  359. macros" (@), "Interact with visuals" (%), and "Interact with colors" (&),
  360. described below.
  361.  
  362. --- User Pref Files (Macros) ---
  363.  
  364.         The "Interact with macros" command allows you to define or remove
  365. "macros", which are mappings from a single logical keypress to a sequence
  366. of keypresses, allowing you to use special keys on the keyboard, such as
  367. function keys or keypad keys, possibly in conjunction with modifier keys,
  368. to "automate" repetitive multi-keypress commands that you use a lot.
  369.  
  370.         Since macros represent keypress sequences, and not all keypresses
  371. have a printable representation, macro triggers and actions must often be
  372. "encoded" into a human readible form.  This is done using several types
  373. of encoding, including "\xHH" for character number HH in hexidecimal, "\e"
  374. for the "escape" code, "\n" for the "newline" code, "\r" for the "return"
  375. code, "\s" for the "space" code, "\\" for backslash, "\^" for caret, and
  376. "^X" for the code for any "control" key "ctrl-X".  Note that the "action"
  377. of a macro will not be checked against other macro triggers (unless the
  378. macro action contains a "control-backslash"), so you cannot make infinite
  379. loops.  You may specify extremely long macros, but you are limited in
  380. length by the underlying input mechanisms, which in general limit you
  381. to about 1024 keys in both triggers and actions.
  382.  
  383.         The special "\" command (which must be encoded in macros as "\\")
  384. is very useful in macros, since it bypasses all keymaps and allows the next
  385. keystroke to be considered a command in the underlying Angband command set.
  386. For a list of the Angband command set, see the "command.txt" help file.
  387. For example, a macro which maps Shift-KP6 to "\" + "." + "6" will induce
  388. the "run east" behavior, regardless of what keyset the user has chosen, and
  389. regardless of what keymaps have been defined.
  390.  
  391.     Macros can be specified in user pref files as a pair of lines, one
  392. of the form "A:<str>", which defines the encoded macro action, and one of
  393. the form "P:<str>", which defines the encoded macro trigger.
  394.  
  395. --- User Pref Files (Keymaps) ---
  396.  
  397.         The "Interact with macros" command also allows you to define
  398. "keymaps", which are vaguely related to macros.  A keymap maps a single
  399. keypress to a series of keypresses, which bypass both other keymaps and
  400. any macros.  Angband uses keymaps to map the original and the roguelike
  401. keysets to the underlying command set, and allows the user to modify or
  402. add keymaps of their own.  Note that all keymap actions must be specified
  403. using underlying commands, not keypresses from the original or roguelike
  404. keysets.  The original keyset is almost identical to the underlying keyset,
  405. except that "numbers" are mapped to ";" plus a direction, "5" is mapped to
  406. ",", and a few control-keys are mapped to various things.  See "command.txt"
  407. for the full set of underlying commands.  Some uses for keymaps include the
  408. ability to "disable" a command by mapping it to "\x00", 
  409.  
  410.     Keymaps can be specified in user pref files as line of the form
  411. "M:<T> <key> <str>", where <T> is the keyset (0/1 for original/roguelike),
  412. <key> is the encoded trigger key, and <str> is the encoded keymap action.
  413.  
  414. --- User Pref Files (Visuals) ---
  415.  
  416.         You can use the "Interact with visuals" command to change various
  417. visual information, currently including the choice of what attr/char values
  418. are used to represent various monsters, objects, or terrain features.  Note
  419. that in combination appropriate support in "main-xxx.c", and with the use of
  420. the "use_graphics" flag, you may be able to specify that "graphic bitmaps"
  421. should be used instead of normal "colored characters" for various things.
  422.  
  423.         When interactively modifying the attr/char values for monsters,
  424. objects, or terrain features, pressing "n" or "N" will change which entry
  425. you are changing, pressing "a" or "A" will rotate through the available
  426. attr values, and pressing "c" or "C" will rotate though the available char
  427. values.  Note that attr/char values with the "high bit" set may induce the
  428. display of special "graphic" pictures if the "use_graphics" flag is set,
  429. and your system supports the "use_graphics" flag.
  430.  
  431.         Note that this command can be abused in various ways, and if you
  432. must do so, remember that you are only cheating yourself.
  433.  
  434.     Keymaps can be specified in user pref files as line of the form
  435. "R:<N>:<A>/<C>" or "K:<N>:<A>/<C>" or "F:<N>:<A>/<C>" or "U:<N>:<A>/<C>".
  436.  
  437. --- User Pref Files (Colors) ---
  438.  
  439.         The "Interact with colors" command allows you to change the actual
  440. internal values used to display various colors.  This command may or may
  441. not have any effect on your machine.  Advanced machines may allow you to
  442. change the actual RGB values used to represent each of the 16 colors used
  443. by Angband, and perhaps even allow you to define new colors which are not
  444. currently used by Angband.
  445.  
  446.     Colors can be specified in user pref files as line of the form
  447. "V:<N>:<V>:<R>:<G>:<B>".
  448.  
  449. --- User Pref Files (Options) ---
  450.  
  451.         The "Interact with options" command allows you to turn options
  452. on or off.  You may turn options off or on using the user pref commands
  453. of the form "X:<option>" or "Y:<option>" respectively.
  454.  
  455.